Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Getting Object Positions

Q3Group_GetNextObjectPosition

You can use the Q3Group_GetNextObjectPosition function to get the position of the next instance of an object in a group.

TQ3Status Q3Group_GetNextObjectPosition (
TQ3GroupObject group, 
TQ3Object object, 
TQ3GroupPosition *position);

group

A group.

object

An object.

position

On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the next instance of the specified object.

DESCRIPTION

The Q3Group_GetNextObjectPosition function returns, in the position parameter, the position of the next instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the last instance of that object in the group, Q3Group_GetNextObjectPosition returns the value NULL in the position parameter.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorNULLParameter